home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-07 / sam303.zip / SAM.DOC < prev    next >
Text File  |  1991-03-01  |  7KB  |  180 lines
  1. SAM - Server Activity Monitor Version 3.03 for LANtastic (tm) networks
  2.  
  3.   (C) Copyright 1990 Humbleware Custom Programming
  4.   247 Paul Martin Drive
  5.   Baltimore, MD 21227
  6.   (301) 799-1975
  7.  
  8. What is SAM?
  9.  
  10.      SAM is an acronym for Server Activity Monitor.
  11.  
  12.  
  13. Why do I need SAM?
  14.  
  15.      If you have a "dedicated" server in your system and have
  16.      wished for a network monitor that could be run without human
  17.      intervention and that would give you a quick assessment of
  18.      network activity with just a quick look over your shoulder
  19.      then SAM is the answer.
  20.  
  21.  
  22. Why was SAM written?
  23.  
  24.      The server monitoring capabilities built into the NET
  25.      program are fine for a quick look-see at a network server.
  26.      The trouble with the NET program is that it requires that
  27.      you tap the space-bar repeatedly to update the monitor screen.
  28.      Like I said, fine for a quick look-see but not very good for
  29.      real-time server monitoring.
  30.  
  31.  
  32. How do I use SAM?
  33.  
  34.      Usage: SAM \\Servername [ [W={P|S}] [U=nnn] [I=nnn] ]
  35.  
  36.        \\Servername  Name of network server to be monitored
  37.  
  38.        Switch │ Meaning                             │ Default │ Options  
  39.        W=     │ display primary or secondary Window │ P       │ P or S   
  40.        U=     │ monitor Users starting at user nnn  │ 1       │ 1 to 290 
  41.        I=     │ sets update Interval to nnn seconds │ 0       │ 0 to 300 
  42.  
  43.        SAM \\Server W=S   - Monitors "Server", display secondary window
  44.        SAM \\Server U=2   - Monitors "Server", monitor users starting at user 2
  45.        SAM \\Server I=5   - Monitors "Server", sets update interval to 5 seconds
  46.  
  47.  
  48.      SAM requires only one command line parameter to operate. You
  49.      must specify the name of a server that you are currently
  50.      logged into.
  51.  
  52.      The Window, User and Interval parameters are optional.
  53.  
  54.  
  55. Enhancements:
  56.  
  57.      SAM 1.05: 
  58.  
  59.      Some LAN operators have noticed that the system clock in
  60.      their servers will occasionally lose a day or two for no
  61.      apparent reason.  This problem stems from the fact that DOS
  62.      will not do any "maintenance" of the system clock unless a
  63.      DOS time/date function call is made by an application
  64.      program.  This "maintenance" of the system clock is pretty
  65.      straightforward.  If a program makes a DOS time/date
  66.      function call, DOS will do two things:
  67.  
  68.      a) DOS will go to the BIOS data area and read the current
  69.      number of clock ticks since midnight and calculate the time
  70.      from this number.
  71.  
  72.      b) DOS will then look for the midnight rollover flag to see
  73.      if a midnight has passed since the clock was queried last.
  74.      If the midnight rollover flag is set DOS increments its
  75.      internal date count and lowers the midnight rollover flag.
  76.  
  77.      The trouble with this scenario is that DOS has no way of
  78.      knowing if more than one midnight has passed since the last
  79.      time the clock was queried.  I the clock is queried at least
  80.      once every 24 hours then the system clock is maintained
  81.      properly.
  82.  
  83.      For most users this is not a problem since they usually turn
  84.      their systems on/off at least once a day or reboot their
  85.      system or run an application program that asks DOS for the
  86.      current time and date.  All of these things cause DOS to
  87.      fetch the current date and time from the system clock and
  88.      perform any maintenance needed.
  89.  
  90.      Now in the case of a LAN server it can happen that the
  91.      server may run for days without any activity at all such as
  92.      over a weekend.  In this case the system will have run for
  93.      more than 24 hours without the benefit of any DOS time/date
  94.      function calls being made.
  95.  
  96.      To correct this DOS/BIOS quirk I added some code to SAM that
  97.      monitors the BIOS data area for the "midnight rollover
  98.      flag."  If SAM detects that midnight has passed it will
  99.      issue a DOS function call to read the date thus forcing the
  100.      system time/date to be maintained properly.
  101.  
  102.  
  103.      SAM 1.06:
  104.  
  105.      The I/O bytes field would overflow if more than 999,999,999
  106.      bytes of data had been registered.  This produced the
  107.      expected "%" (overflow) sign in front of the I/O bytes
  108.      field.  Since I routinely see this condition on the LANs I
  109.      operate I chose to increase the length of the I/O Bytes
  110.      field by one digit.
  111.  
  112.      The I/O Bytes field has been increased in size to display 10
  113.      digits ie: 0,000,000,000 I/O Bytes.  The actual number of
  114.      I/O bytes that can be displayed is 4,294,967,296 I/O Bytes.
  115.      If the number of I/O Bytes exceeds this value the counter
  116.      will simply rollover to zero and begin again.
  117.  
  118.  
  119.      SAM 3.01:
  120.  
  121.      This is a completely rewritten version of SAM that is 
  122.      compatible with LANtastic NOS 3.xx.  The number of changes
  123.      made in the NOS 3.xx made the original SAM act a little
  124.      strangely.  There is no danger in running an older version
  125.      of SAM on a NOS 3.xx system but it is recommended that you
  126.      upgrade to SAM 3.xx.
  127.  
  128.      In rewriting SAM several changes have been made.
  129.  
  130.      1) The appearance of SAM closely conforms to the 'look
  131.      and feel' of Artisoft's NET program (yikes! - could I be 
  132.      facing a look and feel lawsuit?)
  133.  
  134.      2) The Bytes I/O field will display over a trillion bytes I/O
  135.      This should be sufficient to handle the upper limit of the
  136.      NOS.
  137.  
  138.      3) All of the information that is returned by the NOS is now
  139.      displayed. Earlier versions of SAM did not show the Virtual
  140.      Circuit ID number, the number of server requests or the 
  141.      Remote Program Login (R) flag or the Fully Logged in (L)
  142.      Flag. In order to fit all of this information onto the
  143.      screen, SAM now offers two different screens that are user
  144.      selectable from the DOS command line or the keyboard.
  145.  
  146.      4) Last but not least, because SAM was written in Microsoft
  147.      BASIC (Microsoft BASIC PDS (Professional Development
  148.      System)) an incredibly powerful yet easy to use language,
  149.      using the , , I am providing the source code for SAM in the
  150.      hopes that other programmers may decide to make enhancements
  151.      to SAM to suit their own purposes or to use SAM as the basis
  152.      for other LANtastic utilities. For those who do not have
  153.      BASIC PDS, SAM can easily be retrofit by any intermediate
  154.      level QuickBASIC programmer to run under QuickBASIC 4.0 or
  155.      above. If you find the source code to be enlightening or
  156.      otherwise usefull to your projects, please take the time to
  157.      drop me a note or call me and tell me about your project.
  158.  
  159.  
  160.      SAM 3.03:
  161.  
  162.      This version is simply an incremental upgrade that works
  163.      with Artisofts NOS version 3.0 to 3.03.
  164.  
  165.  
  166. Comments:
  167.  
  168.      Please send any comments or suggestions to:
  169.  
  170.           Humbleware Custom Programming
  171.           247 Paul Martin Drive
  172.           Baltimore, MD 21227
  173.           Attn: Larry Westhaver
  174.  
  175.      or you may leave a voice message at this number:
  176.  
  177.           (301) 799-1975 (answering machine)
  178.  
  179.  
  180.